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Preface 


This Remote Server Management Administration Guide includes information 
about understanding, setting up, and managing the Remote Console utility 
(RConsoleJ). 


RConsoleJ lets you use a network workstation to control and manage a remote 
NetWare® server. You can lock servers in a safe place, remove keyboards and 
monitors, and then start a remote control session from a workstation whenever 
you need to access a server’s console. 


NetWare 6 RConsoleJ has new sleek and user-friendly interface. 


Documentation Conventions 


In this documentation, a greater-than symbol (>) is used to separate actions 
within a step and items in a cross-reference path. 


Also, a trademark symbol (E TM. etc.) denotes a Novell trademark. An asterisk 
(*) denotes a third-party trademark. 
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Remote Server Management 


NetWare® 6 provides Java*-based remote console utility (RConsoleJ) that lets 
you control a NetWare server from a workstation and perform the following 
tasks: 


* Use console commands as you would at the server console 


* Use NLM™ programs as you would at the server console (for example, 
EDIT.NLM to edit files) 


* Send console commands in the server's native language from the 
RConsoleJ Client using Buffer Input. 


* Control the server from another server using RConsoleJ 
* Upgrade a NetWare server (text-based UI only) 
* Secure Socket Layer (SSL) based secure session 
This chapter contains the following topics: 
* What's New in NetWare 6 RConsoleJ (page 10) 
* Overview of RConsoleJ Components (page 10) 
* Setting Up RConsoleJ (page 11) 
* Loading Agents at Startup (page 13) 
* Deploying RConsoleJ (page 14) 
* Managing Remote NetWare Servers (page 19) 
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What’s New in NetWare 6 RConsoleJ 


+ 


Send lengthy console commands to the server using the new Buffer Input 
utility. You can also send commands in the server’s native language using 
Buffer Input. 


See “Sending Console Commands in the Server’s Native Language” on 
page 19. 


* Supports SSL-based secure session using the Secure IP connection 
option. 


See “Setting Up a Secured IP Connection” on page 14. 


For more information on SSL, see the SSL documentation (http:// 
home.netscape.com/eng/ss13/draft302.txt). 


* Supports Unsecure IP connection for backward compatibility with 
NetWare 5 and NetWare 6. 


See “Setting Up an Unsecure IP Connection” on page 16. 


Overview of RConsoleJ Components 


Before setting up RConsoleJ, you should understand the RConsoleJ 
components. The following RConsoleJ components interact with each other to 
help you remotely control a NetWare server: 


RConsoleJ Client 


The RConsoleJ Client is a Java-based utility running on a Java-enabled 
workstation or NetWare server. From the RConsoleJ Client you can remotely 
control and monitor all NetWare console operations. 


RConsoleJ Agent 


The RConsoleJ Agent (RCONAG6.NLM) is a utility running on the target 
NetWare server. The target NetWare server can be connected over IP, IPX™, 
or IP/IPX running the RConsoleJ Agent. The RConsoleJ Agent services all 
RConsoleJ Client requests. 


The RConsoleJ Agent advertises its services using Service Location Protocol 
(SLP). 
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RConsoleJ Proxy Agent 


The RConsoleJ Proxy Agent (RCONPRXY.NLM) is a utility running on a 
NetWare server. It routes all IP packets to IPX and vice versa. 


The RConsoleJ Proxy Agent advertises its services using Service Location 
Protocol (SLP). 


IMPORTANT: If the target NetWare server uses only IPX, the NetWare server 
(loaded with the RConsoleJ Proxy Agent) must have both IP and IPX stacks 
installed. 


Setting Up RConsoleJ 


Loading the RConsoleJ Agent 


1 


At the server console prompt, enter 
RCONAG6 


Enter the password you want network administrators to use when 
accessing the target NetWare server using RConsoleJ. 


Enter the TCP port number for the unsecure session. 
The default value is 2034. 


If the server communicates using IPX only, enter —1 to disable TCP 
listening. 


To enable listening over a dynamically assigned port, enter 0. 
Enter the TCP port number for the secure session. 
The default is 2036. 


Ensure the Key Material Object named SSL CertificateDNS has been 
created. 


NOTE: The Secure connection is available only on IP and not on IPX. 


Enter the SPX™ port number on which RCONAG6 will listen for a proxy 
server. 


The default is 16800. 


If the server communicates using IP only, enter —1 to disable SPX 
listening. 


To enable listening over a dynamically assigned port, enter O. 


NOTE: /DEV/TCP and /DEV/TCPSSL will fail if you are using a pure IPX server. 
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Running the RConsoleJ Client 


On a Workstation 


You can run the RConsoleJ Client on a workstation using either of the 
following methods: 


* 


On a NetWare Server 


From a Windows* 95/98 or Windows NT* workstation, ensure you have 
a drive mapped to the root of volume SYS: on the NetWare 6 server. From 
the Windows desktop menu, click Start > Run, browse to 
\PUBLIC\MGMT\CONSOLEONE\1.2, and run RCONJ.EXE. 


In ConsoleOne™, right-click the NetWare server object that you want to 
remotely control and click Remote Console, or click the NetWare server 
object and then from the Tools option click Remote Console. 


You can run the RConsoleJ Client on a NetWare server using any of the 
following methods: 


* 


In ConsoleOne, right-click the NetWare server object that you want to 
remotely control and click Remote Console, or click the NetWare server 
object and then from the Tools option click Remote Console. 


From the server console prompt, enter RCONJ . NCF. 


From the server GUI, click Novell > Programs > RConsoleJ. 


Loading the RConsoleJ Proxy Agent on a Proxy Server 


The NetWare server loaded with RConsoleJ Proxy Agent should have an IP/ 
IPX stack loaded. 


1 


At the server console prompt, enter the following command: 
RCONPRXY 


Enter the TCP port number on which RCONPRXY will listen for 
RConsoleJ. 


The default is 2035. 
To enable listening over a dynamically assigned port, enter 0. 


Once the NetWare server is running the RConsoleJ Proxy Agent, the 
RConsoleJ Client can communicate through it with the target NetWare 
server that uses only IPX to communicate. 
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Loading Agents at Startup 


Loading RConsoleJ Agent at Startup 


You can load RConsoleJ Agent (RCONAG6.NLM) at startup using either of 
the following methods. 


Using Encrypted Password (Recommended) 
1 Prepare the LDRCONAG.NCE script file. 
1a At the console prompt, enter rconag6 ENCRYPT. 


1b In the RConsoleJ Agent server screen, enter the password and port 
numbers. 


1c Enter Y. 


2 Prepare the AUTOEXEC.NCF file to run the LDRCONAG.NCF script 
file at startup. 


2a Comment out the following line: 
load rconag6 Your Password Here 2034 2036 16800 
2b Enter the following line: 


ldrconag 


Using Plain Text Password 


Enter the following line in AUTOEXEC.NCF: 


load rconag6 your password 2034 2036 16800 


Loading RConsoleJ Proxy Agent at Startup 


To load the RConsoleJ Proxy Agent (RCONPRXY.NLM) at the startup, enter 
the following line in AUTOEXEC.NCF: 


load rconprxy 2035 
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Deploying RConsoleJ 


This section will help you deploy RConsoleJ in the following scenarios: 


* Scenario 1: An IP Client Consoling an IP or IP/IPX NetWare Server (page 
14) 


* Scenario 2: An IP Client Consoling an IPX NetWare Server (page 17) 


Scenario 1: An IP Client Consoling an IP or IP/IPX NetWare Server 


Prerequisites 
U Loading the RConsoleJ Agent (page 11) 
U Running the RConsoleJ Client (page 12) 


Setting Up a Secured IP Connection 


The RConsoleJ Client communicates directly with the RConsoleJ Agent using 
TCP/IP. 
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The RConsoleJ Client 
communicates over IP 


Workstation NetWare 
Server 
Secure IP Target 
E ere Se v 
S. 





The target server is 
controlled from the 
client 


In the RConsoleJ Connection dialog box, select Secure IP. 


Enter the IP address of the target NetWare server, or click the Remote 
Servers icon and then select the target NetWare server from the list. 


Enter the password provided during loading of the RConsoleJ Agent on 
the target server. 


Enter the port number. 
The default is 2036. 
Click Connect. 


To ensure server authentication, read the Untrusted Certificate 
Verification server certificate issued by the target server and click OK to 
accept. 
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Setting Up an Unsecure IP Connection 


The RConsoleJ Client communicates directly with the RConsoleJ Agent using 
TCP/IP. Use the Unsecure IP connection for backward compatibility with 
NetWare 5.x server RConsoleJ Agents. 


The RConsoleJ Client 
communicates over IP 


oleJ Cie 
a le, 


e 
$ 
Workstation NetWare 
Server 
Target 
E are Se ^, 
Unsecure S. 


TS 





The target server is 
controlled from the 
client 


1 In the RConsoleJ Connection dialog box, select Unsecure. 
2 Select Connect Directly as the unsecure connection option. 


3 Enter the IP address of the target NetWare server, or click the Remote 
Servers icon and then select the target NetWare server from the list. 


4 Enter the password provided during loading the RConsoleJ Agent. 
5 Enter the port number. 

The default is 2034. 
6 Click Connect. 
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Scenario 2: An IP Client Consoling an IPX NetWare Server 


Prerequisites 
U Loading the RConsoleJ Agent (page 11) 
U Running the RConsoleJ Client (page 12) 
U Loading the RConsoleJ Proxy Agent on a Proxy Server (page 12) 


Setting Up an Unsecure IPX Connection 


The RConsoleJ Client communicates with the RConsoleJ Agent through 
RConsoleJ Proxy Agent because the target NetWare server is based purely on 
IPX. 


The RConsoleJ Proxy Agent is loaded on a NetWare server (proxy server) that 
has both IP and IPX stacks loaded. The RConsoleJ Proxy Agent receives all 
the IP requests from the RConsoleJ Client, converts them to IPX requests, and 
then sends them to the RConsoleJ Agent and vice-versa. 
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The proxy server provides 


The RConsoleJ Client access to IPX-only target 
communicates over IP servers (and IP servers if 
desired).* 
IP 


\eJ CH ^» AS Xy Ser 
AS Yep, go Ve. 


a 5 


Q&Q 
Workstation NetWare 
Server 





The target server is 
controlled from the 
client 


*If the target server uses IPX, the proxy server must have 
both IP and IPX stacks loaded. 
1 Inthe RConsoleJ Connection dialog box, select Unsecure. 
2 Select Connect Via Proxy as the unsecure connection option. 


3 Enterthe IP/IPX address ofthe target NetWare server, or click the Remote 
Servers icon and then select the target NetWare server from the list. 


Following is a sample IPX number: 
IPX Address:000000000001 


4 Enter the port number specified during loading the RConsoleJ Agent on 
the target server or choose appropriate protocol to use the default port 
number. 


The default is 2034 for Unsecure IP. 
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5 Enter the IP address of the proxy server, or click the Remote Servers icon 
and then select a proxy server from the list. 


6 Click an agent protocol depending on the protocol of the target server. 


7 Enter the port number specified during loading the RConsoleJ Proxy 
Agent. 


The RConsoleJ Client communicates with the RConsoleJ Proxy Agent on 
this port. 


The default is 2035. 


8 Enter the password provided during loading the RConsoleJ Agent on the 
target NetWare server. 


9 Click Connect. 


Managing Remote NetWare Servers 


After RConsoleJ establishes connection with the NetWare server, you can 
view and manage the target NetWare server from your desktop. 


The following sections explain the tasks you can perform to effectively 
manage a remote NetWare Server. 
Sending Console Commands in the Server's Native Language 


You can send console commands in the server's native language from the 
RConsoleJ Client using Buffer Input as shown in the following graphic. The 
buffer stores a list of ten history commands. 
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BS Novell RConsoleJ: JAP-185 
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Copyright 1989-1998 Novell, Inc. All rights reserved. 
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To send console commands, do the following: 


1 From the Novell RConsoleJ Client window, enter the command that you 
want to run at the target server in the Buffer Input field. 


2 Click Send. 


Synchronizing RConsoleJ Client and Target NetWare Screens 


You can synchronize the screen displayed on the target NetWare server and the 
screen displayed on the RConsoleJ Client with each other. Switching the 
screen in the RConsoleJ Client switches the screen at the target server console 
and vice versa. 


To synchronize the screens, from the Novell RConsoleJ window, click Sync. 


To switch the screen on the server console to the currently activated screen on 
the RConsoleJ Client, click Activate. 
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